table of contents
guestfs-python(3) | Virtualization Support | guestfs-python(3) |
名前¶
guestfs-python - Python から libguestfs を使用する方法
書式¶
import guestfs g = guestfs.GuestFS(python_return_dict=True) g.add_drive_opts("disk.img", format="raw", readonly=1) g.launch()
説明¶
This manual page documents how to call libguestfs from the Python programming language. This page just documents the differences from the C API and gives some examples. If you are not familiar with using libguestfs, you also need to read guestfs(3).
python_return_dict=True¶
All new code should construct the handle using:
g = guestfs.GuestFS(python_return_dict=True)
This indicates that your program wants to receive Python dicts for methods in the API that return hashtables.
In a future version of libguestfs, this will become the default.
例外¶
Errors from libguestfs functions are mapped into "RuntimeException" with a single string argument which is the error message.
MORE DOCUMENTATION¶
Type:
$ python >>> import guestfs >>> help(guestfs)
USING PYTHON BINDINGS IN A VIRTUALENV¶
These bindings are not available in pypi owing to a licensing problem. See https://bugzilla.redhat.com/1075594 for current status.
However we do publish a Python distribution for selected stable versions of libguestfs in http://libguestfs.org/download/python. You can use it like this:
pip install http://libguestfs.org/download/python/guestfs-1.XX.YY.tar.gz
例 1: ディスクイメージの作成¶
@EXAMPLE1@
例 2: 仮想マシンのディスクイメージの検査¶
@EXAMPLE2@
関連項目¶
guestfs(3), guestfs-examples(3), guestfs-erlang(3), guestfs-gobject(3), guestfs-golang(3), guestfs-java(3), guestfs-lua(3), guestfs-ocaml(3), guestfs-perl(3), guestfs-recipes(1), guestfs-ruby(3), http://libguestfs.org/.
著者¶
Richard W.M. Jones ("rjones at redhat dot com")
COPYRIGHT¶
Copyright (C) 2010-2012 Red Hat Inc.
LICENSE¶
BUGS¶
To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
When reporting a bug, please supply:
- The version of libguestfs.
- Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
- Describe the bug accurately and give a way to reproduce it.
- Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
2021-01-05 | libguestfs-1.44.0 |